QT4.6.3文档翻译：QTabWidget类参考，QTabWidget Class Reference

详细描述

QTabWidget类提供以标签方式显示的部件组成的一个堆叠。

一个标签部件提供一个标签条(参见 QTabBar )和一个用来显示与每个标签相关的页面的 “页面区域”。默认地 ，标签条显示在页面区域的上方，但是也可以使用不同的配置 (参见 TabPosition ) 。每个标签与一个不同的部件 （称做页面）关联。只有当前页面是在页面区域里显示的 ；其它所有的页面被隐藏。要显示一个不同的页面 ， 用户可以点击它的标签 ，或者如果它有Alt+ 字母 快捷键的话按快捷键也可以。

使用QTabWidget的通常方式是下面这样的：

1. 1.创建一个QTabWidget。

2. 2. 为标签对话框中的每个页面创建一个 QWidget ，但是不为它们指定亲代部件 。

3. 3.将子代部件插入到页面部件中，像通常一样使用布局来安排它们的位置 。

4. 4. 调用 addTab ()或者 insertTab ()来将这个页面部件放入标签部件里面 ，为每个标签赋予一个合适的文本标签和一个可选的快捷键 。

标签的位置由 tabPosition 定义 ，形状由 tabShape 定义 。

当用户选择一个页面时 ，信号 currentChanged ()被发射。

当前页面的索引可以使用 currentIndex ()获得 ，当前页面部件可以使用 currentWidget ()获得。你可以使用一个给定的索引通过 widget ()来获取到一个页面部件的指针 ，而且可以使用 indexOf ()来找到一个部件的索引位置 。使用 setCurrentWidget ()或者 setCurrentIndex ()来显示一个特定的页面 。

你可以使用 setTabText ()或者 setTabIcon ()来修改一个标签的文字和图标 。一个标签和它关联的页面可以使用 removeTab ()删除 。

每个标签在任何时候或者是启用的 ，或者是禁用的(参见 setTabEnabled ())。如果一个标签是启用的 ，标签文字是正常绘制的并且用户可以选择这个标签 。如果它是禁用的 ，标签被以一种不同的方式来绘制并且用户无法选择那个标签 。注意即使一个标签被禁用 ，它的页面可能仍然是可见的 ，例如在所有的标签都碰巧被禁用的情况下 。

标签部件是一种很好的分割一个复杂的对话框的方式 。另一种方法是使用 QStackedWidget ，并且你为它提供一种在页面之间导航的方法，例如，一个 QToolBar 或者一个 QListWidget 。

QTabWidget 中大部分的功能是由一个 QTabBar （在顶部，提供标签）和一个 QStackedWidget （大部分的区域，组织单个的页面）提供的。

一个Windows XP风格的标签部件。	一个Macintosh风格的标签部件。	一个Plastique风格的标签部件。

参见 QTabBar ， QStackedWidget ， QToolBox ，和 标签对话框示例。

函数 setTabText( int  index , const  QString  &  label )

void QTabWidget::setTabText ( int  index , const  QString  &  label  )

为位置为index的标签的页面定义一个新的文本标签 。

如果提供的文本包含一个 ＆符号，会自动为它创建一个快捷键 。跟在'&'后面的字符会被用作快捷键 。此前的任何快捷键会被覆盖 ，或者如果文字里面没有定义快捷键则会被清除。参见 QShortcut 文档以了解细节 （要显示一个实际的＆，使用'&&'）。

参见 tabText () 。

函数 indexOf (  QWidget  *  w  )

int QTabWidget::indexOf (  QWidget  *  w  ) const

返回由部件w拥有的页面的索引位置，或者如果部件无法被找到则返回-1。

信号 currentChanged ( int  index  )

void QTabWidget::currentChanged ( int  index  )    [signal]

当任何时候当前的页面索引发生改变时 ，这个信号被发射。参数是新的当前页面 索引 位置 ，或者如果没有新的当前页面则参数是 -1 （例如，如果在 QTabWidget 中没有部件）。

参见 currentWidget ()和 currentIndex 。

Your opinions

Your name:Email:Website url:Opinion content:Send